Skip to main content
Version: 8.6.10.4

CCodeDefinitionV3

V8 Message Definiton

Commodity code (product code) definitions for all futures, and the ccode -> SpiderRock ticker map. Sourced from listing exchange product definitions. Also covers exchange and user-defined spreads, including spreads used as option underliers; SpiderRock uses a compact form of the exchange spread product ID as the ccode where no human-readable exchange ticker exists. A family head begins with '@'; no product key or uplink does. Two links. Field 103 ticker is the LINE the product derives from: a single-name product names its equity line (the EquityDefinitionV3 9106 row with the ISIN), an index product its index line (IndexDefinitionV3 9109), a dividend product its parent's dividend line; a commodity, rate, FX or futures-on-futures product, and any product its region cannot resolve, names itself. Never a @ head. Nothing hangs on an obligor. Field 250 familyHead is the FAMILY: one venue's products on one underlier, @[underlier]-[venue]-FUT, a head a loader names after its outright (@ES), or a declared family (the common US families: ES and MES under @ES, VXM and its TAS under @VIXMIN), whose Primary is declared with it. Every product is its own complex; a head answers through the family's Primary. DOMAIN TERMS ARE ATTACHED RECORDS on the same ccode pkey, not fields here: RepoTermsDefinitionV3 9245, TbaTermsDefinitionV3 9248, SwapTermsDefinitionV3 9251, ReceiptBasketDefinitionV3 9254. READ symbolType TO CLASSIFY THE CCODE (CCode | RepoProduct | TbaContract | SwapProduct | CommodityProduct), never the presence of a terms record.

METADATA​

AttributeValue
Topic9100-product-def-core
MLink TokenFutureDefinition
ProductSRReference
accessTypeSELECT
MLink EndpointMLink-Live

Table Definition​

FieldTypeKeyDefault ValueComment
ccode_atenum - AssetTypePRI'None'the futures product code AT and TS identify the universe it belongs to
ccode_tsenum - TickerSrcPRI'None'the futures product code AT and TS identify the universe it belongs to
ccode_tkVARCHAR(12)PRI''the futures product code AT and TS identify the universe it belongs to
micVARCHAR(4)''ISO 10383 listing venue
ticker_atenum - AssetType'None'the line the product derives from and settles into else the product itself never a head
ticker_tsenum - TickerSrc'None'the line the product derives from and settles into else the product itself never a head
ticker_tkVARCHAR(12)SEC''the line the product derives from and settles into else the product itself never a head
settleTimeenum - SettleTime'None'Settlement time None PM AM
positionLimitINT0max contract limit
tickValueFLOAT0NLV value of a single tick change in display premium pointValue tickValue tickSize
pointValueFLOAT0NLV value of a single point change in display premium pointValue tickValue tickSize
pointCurrencyVARCHAR(3)''ISO 4217 currency pointValue is denominated in
priceScalingFLOAT0underlying price scale factor products where the underlying quotes in cents will have 001
underliersPerCnINT0the products standard contract size shares index units or currency units per contract
underlierTypeenum - UnderlierType'None'what the product derives from Equity Index Rate Commodity FX Other unclassified
contractUnitenum - ContractUnit'None'BBL MMBTU LBS CTRCT
tradeCurrVARCHAR(3)''unit the contract is quoted in ISO 4217 or GBX where the venue quotes pence money is pointCurrency
settleCurrVARCHAR(3)''ISO 4217 currency the contract settles in
strikeCurrVARCHAR(3)''unit strikes are quoted in ISO 4217 or GBX for pence strikes
priceFormatenum - PriceFormat'None'the quote convention for this product
clearingCodeVARCHAR(6)''GMIClearing code
displayPriceScalingFLOAT0internal display price scale factor override
strikeScalingFLOAT0internal strike price scale factor override
descriptionVARCHAR(48)''product description
marketCenterVARCHAR(48)''market center eg ICE Market Type CME MarketGroup
tradingPeriodenum - TradingPeriod'None'the rotation rule that sets this products trade date TradingPeriodDefinitionV3 9015
isHftTaxLiableenum - YesNo'None'if Yes futures in this ccode grouping are liable for high frequency taxation and require hft throttling for maker algos
hftTaxTriggerTimeDOUBLE0value in seconds that any order activity new cancel update needs witheld for to prevent triggering hft default 5 seconds per Italian tax
clearVenueVARCHAR(8)''ClearVenueDefinitionV3 where contracts in this ccode clear
v3Sourceenum - V3Source'None'Bridge projected from a legacy record Loader written natively None reads as Loader
timestampDATETIME(6)'1900-01-01 00:00:00.000000'when this row was last written
scheduleGroupVARCHAR(6)''ScheduleDefinitionV3 9057 empty
marketSegmentIdVARCHAR(24)''venue market segment id
productGroupVARCHAR(6)''venue product group CME Asset
securityGroupVARCHAR(6)''venue security group CME SecurityGroup
settlementDaysTINYINT UNSIGNED0Tn of the current regime 0 means T0 never unknown
flexTypeFlagVARCHAR(255)'None'FLEX series types that may be MINTED on this underlier None no FLEX A FLEX order mints a root before any root exists
bbgYrCodeenum - BbgYrCode'None'Bloomberg yearcode convention for this product history and the FIX symbol builders read it
hasOptionsenum - YesNo'None'HINT options list on this product subscription filter only never a pricing or risk branch
liveRateKey_atenum - AssetType'None'empty MRGNpointCurrencyRATE
liveRateKey_tsenum - TickerSrc'None'empty MRGNpointCurrencyRATE
liveRateKey_tkVARCHAR(12)''empty MRGNpointCurrencyRATE
minTickSizeDOUBLE0the products tick the smallest its contracts state
roleenum - FamilyRole'None'
defaultRoot_atenum - AssetType'None'
defaultRoot_tsenum - TickerSrc'None'
defaultRoot_tkVARCHAR(12)''
productKindenum - FuturesProductKind'None'Outright Physical DividendAdjusted TotalReturn Dividend Variance Volatility TradeAtSettlement TradeAtMarker BasisTradeAtClose a BTIC quotes a basis to the index close none of the last three is ever a Primary
familyHead_atenum - AssetType'None'
familyHead_tsenum - TickerSrc'None'
familyHead_tkVARCHAR(12)''

PRIMARY KEY DEFINITION (Unique)​

FieldSequence
ccode_tk1
ccode_at2
ccode_ts3

SECONDARY INDEX (TickerIndex) (Not Unique)​

FieldSequence
ticker_tk1

SELECT TABLE EXAMPLE QUERY​

SELECT *
FROM `SRReference`.`MsgCCodeDefinitionV3`
WHERE
/* Replace with a ENUM('None','EQT','IDX','BND','CUR','COM','FUT','SYN','WAR','FLX','MUT','SPD','MM','MF','COIN','TOKEN','ANY','RATE','CRDT','GCR','SWAP','ENT','MBS','SET','LOAN') */
`ccode_at` = 'NONE'
AND
/* Replace with a ENUM('None','SR','NMS','CME','ICE','CFE','CBOT','NYMEX','COMEX','RUT','CIDX','ARCA','NYSE','OTC','NSDQ','MFQS','MIAX','DJI','CUSIP','ISIN','BXE','SCE','ANY','CXE','DXE','NXAM','NXBR','NXLS','NXML','NXOS','NXP','EUREX','CEDX','ICEFEC','ICEFEF','CEQT','TSX','TMX','CRCY','CMDY','DTI','SOVN','SR_US','SR_EU','SR_AP','SR_UK','USD','EUR','GBP','CHF','JPY','CAD','AUD','HKD','KRW','INR','SGD','TWD','CNY','CNH','BRL','MXN','ZAR','SEK','NOK','DKK','PLN','ILS','TRY','NZD','THB','MYR','IDR','PHP','CZK','HUF','SAR','AED','CLP','COP') */
`ccode_ts` = 'NONE'
AND
/* Replace with a VARCHAR(12) */
`ccode_tk` = 'Example_ccode_tk';

Doc Columns Query​

SELECT * FROM SRReference.doccolumns WHERE TABLE_NAME='CCodeDefinitionV3' ORDER BY ordinal_position ASC;